% !TEX root = main.tex

\section{Get GeKo Ready}
\label{sec:get_geko_ready}

This section illustrates our experiment environment and how to get GeKo ready for further case study.

\subsection{System Environment}

\subsubsection{Operating System.}
This is not a must requirement. We just conducted our case study in \emph{Mac OS X, version 10.7.5}.
We have not tested other operating systems.

\subsubsection{Modeling and Developing Environment.}
All modeling and developing tasks are completed in \emph{Eclipse Modeling Tools, Juno service release 2}\footnote{\url{http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/junosr2}}
(we are using Mac OS X 64-bit package).

\subsection{GeKo Package}
\label{sec:geko}
You can checkout the entire GeKo package at:\\ \url{https://code.google.com/a/eclipselabs.org/p/geko-model-weaver/}. 
You can also checkout the GeKo with our case study at \url{https://code.google.com/p/ram-geko/}.
\jackin{commit all GeKo bug fixings to original GeKo project}

\begin{figure}[htbp]
	\centering
	\includegraphics[width=0.8\textwidth]{figure/geko/GeKo_package}
	\caption{Overview of GeKo package}
	\label{fig:GeKo_package}
\end{figure}

The GeKo package is organized as shown in \fig \ref{fig:GeKo_package}. The description of the GeKo package is as follows:
\begin{itemize}
	\item \textbf{core}: This folder contains main projects of GeKo. \emph{You need to import all projects under this folder to your eclipse environment}.
	\item \textbf{doc}: This folder contains all generated Java docs of all GeKo source code projects in the \emph{core} folder.
	\item \textbf{extension}: This folder is used to save user-defined projects for extending GeKo for specific metamodels, if necessary additional coding is needed.
		Currently please ignore all contents in this folder.
	\item \textbf{examples}: This folder is used to save user-defined projects for modeling and model weaving case studies. Our case study will be stored in this
		folder later. Currently please ignore all contents in this folder.
	\item \textbf{epl-v10.html} and \textbf{epl-v10.txt}: These files are Eclipse Public License. The GeKo (and our case study stuff) is under the code license
		\emph{Eclipse Public License 1.0}. You need not to care about them.
\end{itemize}

When you finish importing and building all projects in the \emph{core} folder to your eclipse environment, you will find there are errors in the manifest file
of the project \emph{lu.uni.geko.joinpointdetection.drools}. \textbf{Currently please ignore these errors and we will fix them later in the case study manually}.
We are terribly sorry for the inconvenience.

\subsection{Start GeKo}

\begin{figure}[htbp]
	\centering
	\includegraphics[width=0.7\textwidth]{figure/geko/run_eclipse}
	\caption{Start a new eclipse application with all GeKo features}
	\label{fig:run_eclipse}
\end{figure}

\begin{figure}[htbp]
	\centering
	\includegraphics[width=0.8\textwidth]{figure/geko/start_geko}
	\caption{GeKo features are enabled in the new eclipse application}
	\label{fig:start_geko}
\end{figure}

Since GeKo is developed as an eclipse plugin, to use GeKo, you have to select the main project \emph{lu.uni.geko} and run it as a new \emph{Eclipse Application}, see \fig \ref{fig:run_eclipse}.
In the new eclipse instance, you can find all GeKo features, see \fig \ref{fig:start_geko}.